home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / prog_disc / volume_2 / issue_02 / extras / smith / txtmanual < prev   
Encoding:
Text File  |  1988-09-22  |  9.2 KB  |  205 lines

  1.                          PRINTER DRIVER GENERATOR
  2.  
  3.                                    FOR
  4.  
  5.                              FIRST WORD PLUS
  6.  
  7.                                Version 1.00
  8.  
  9.  
  10. Introduction
  11.  
  12.        The  Printer  Driver Generator for First Word Plus is  designed  to 
  13.        remove  the  necessity for editing the rather  complex  hex  files. 
  14.        Instead, a user-friendly program can be run to 'edit' the file, and 
  15.        "1stInstall" can be run as normal to "compile" the edited source.
  16.  
  17. Limitations
  18.  
  19.        The  current  version of PDG cannot edit a loaded  hex  file  using 
  20.        decimal  characters.  However,  a keystroke mode is  available  for 
  21.        editing.
  22.  
  23.        Decimal  mode may only be used for the initial entry of  a  printer 
  24.        driver. Once saved, the codes are converted into hex.
  25.  
  26.        The  'P'  notation for placeholders described below  is  translated 
  27.        into the native 'high bit set' notation when a driver is saved.  It 
  28.        is not translated back when a driver is loaded.
  29.  
  30. Modes of Operation
  31.  
  32.        PDG has three basic modes of operation:
  33.  
  34.        1)   Configuration is used to define the six bytes of configuration 
  35.             status.  This  mode is different from the others since  it  is 
  36.             always in decimal mode.
  37.  
  38.        2)   Printer Characteristics is used to define the control codes to 
  39.             be sent to the printer to perform certain tasks.
  40.  
  41.        3)   Character  Translation  is used to define the  subset  of  the 
  42.             Archimedes character set that may be sent to the  printer.  It 
  43.             controls  whether a particular Archimedes character is  to  be 
  44.             ignored, sent directly to the printer, or be translated into a 
  45.             string before being output.
  46.  
  47. Colour Codes
  48.  
  49.        To  assist  the  majority of Archimedes owners who  have  a  colour 
  50.        monitor,  PDG  uses  colour throughout.  The colour  codes  are  as 
  51.        follows:
  52.        Red     - Prompt for user input
  53.        Cyan    - Output text
  54.        Green   - Default values and error messages
  55.        Yellow  - User input
  56.  
  57.        The Character Translation mode uses colour in a slightly  different 
  58.        manner - see below.
  59.  
  60. Starting the Program
  61.  
  62.        On  starting  the program,  the user will be given  the  option  of 
  63.        loading an existing printer driver hex file. If this opportunity is 
  64.        taken,  a catalogue of the directory "&.1WP.hex" is displayed,  and 
  65.        the  user  is prompted for a filename.  To avoid  loading  a  file, 
  66.        simply press the <Escape> key.  If it could be found, the specified 
  67.        file is then loaded.
  68.  
  69. Configuration
  70.  
  71.        The user is now placed in Configuration mode.  Up to six  questions 
  72.        will  be asked.  They will either warrant a Yes/No or  a  (decimal) 
  73.        number answer. If the prompt is '?', answer by pressing "Y" or "N". 
  74.        If the prompt is '===>' then answer by keying a decimal number  and 
  75.        pressing <Return>.
  76.  
  77.        If any (green) value appears following the (red) prompt,  then this 
  78.        is a default value. To accept it, just press <Return>.
  79.  
  80. Printer Characteristics
  81.  
  82.        This is the most-used mode of the program.  Various questions  will 
  83.        be asked,  all of them requiring a string response (see below). The 
  84.        only  exceptions to this rule are the Yes/No questions that may  or 
  85.        may not be asked. These are detailed below:
  86.  
  87.        "Do you want to input data in hex?"
  88.             This  is only asked if no printer driver has  been  previously 
  89.             loaded.  If the answer is Yes,  all further responses in  this 
  90.             section are assumed to be in hex. If the answer is No, further 
  91.             responses are assumed to be in decimal.
  92.  
  93.        "Do you want to include commands for printing in NLQ?"
  94.             This  question,  only asked if defining a driver for a  matrix 
  95.             printer,  is  to save the bother of separately defining  codes 
  96.             for NLQ.  If the question is answered with Yes,  the codes for 
  97.             NLQ will be prompted for separately.  If answered with No, the 
  98.             NLQ codes will not be prompted for.  Answer No if the  printer 
  99.             does  not support NLQ,  or if the highlight codes in  NLQ  all 
  100.             exactly match those in draft mode.
  101.  
  102. Specifying the code string
  103.  
  104.        This is generally done by keying a string of decimal or hex numbers 
  105.        (the  top-left  corner  of  the  screen  shows  the  current  mode) 
  106.        separated by spaces.
  107.  
  108.        For  example,  the  code  to turn underlining on for  an  EPSON  FX 
  109.        printer is entered in decimal as "27 45 1" and in hex as "1B 2D 1". 
  110.        However,  the  printer  manual  may  well  list  this  sequence  as                 
  111.        "Esc '-' 1".
  112.  
  113.        Fortunately,  PDG  does provide another way of specifying the  code 
  114.        string.  For  printable characters (and most non-printable  charac-
  115.        ters,  but  not escape) it is quite easy.  Simply press the  single 
  116.        quote key "'" and then press the required key. The second keystroke 
  117.        made will be converted into the relevant ASCII code,  and displayed 
  118.        in either hex or decimal,  according to the current setting.  It is 
  119.        not  necessary  to enter the close  quote.  So,  in  decimal  mode, 
  120.        "27 45 1" may be entered as "27 '- 1".
  121.  
  122.        In  other respects,  entering a code string is similar to  entering 
  123.        the  configuration  options as above,  in that  the  green  default 
  124.        property  occurs here also.  Note however that if a code is  to  be 
  125.        removed from the printer driver,  and a default is given,  pressing 
  126.        <Return>  will accept the default.  To cancel  the  default,  press 
  127.        <Space> before <Return>.
  128.  
  129. Using placeholders
  130.  
  131.        Certain  commands (for example vertical tab) require the use  of  a 
  132.        placeholder.  A  placeholder byte signifies the position  in  which 
  133.        First Word Plus will insert a numeric value in the command  string. 
  134.        However, many printers will not accept a simple value counting from 
  135.        zero (as 1st Word Plus wishes to output), so the facility exists to 
  136.        force  1st Word Plus to add a constant to the numeric value  before 
  137.        output.  Typically,  a  printer will require 1st Word Plus  to  add 
  138.        either  1,  0  or  32 (to make the  command  argument  a  printable 
  139.        character).
  140.  
  141.        To insert a placeholder,  simply type 'P' in the command string. To 
  142.        force  1st  Word Plus to add 1 use 'P1'.  To add 32  use  'P32'  in 
  143.        decimal mode, or 'P20' in hex mode.
  144.  
  145.        Since  placeholders are internally stored by '1stInstall' as  bytes 
  146.        with  the high bit set,  when editing an existing  file,  'P'  will 
  147.        appear  as '80',  'P1' as '81' and 'P32'/'P20' as  'A0'.  Thus  any 
  148.        character value of greater than hex 7F is treated as a placeholder.
  149.  
  150.        The commands that require placeholders are indicated by the  suffix 
  151.        '[P]' in the prompt.
  152.  
  153.  
  154. Changing Character Translations
  155.  
  156.        Once  the last characteristic has been entered,  the  program  goes 
  157.        into character translation mode.  A matrix of Archimedes characters 
  158.        is displayed, and the mouse pointer appears.
  159.  
  160.        If  a character is displayed in the matrix in yellow,  it  will  be 
  161.        sent directly to the printer. If it is displayed in red, it will be 
  162.        ignored at print time. If it is displayed in green, then there is a 
  163.        character translation string set up for that character.
  164.  
  165.        To  change the colour of a character in the matrix (and hence  it's 
  166.        printer availability),  point to it with the mouse,  and press  the 
  167.        relevant button:  Select for yellow, Menu for green, and Adjust for 
  168.        Red.
  169.  
  170.        When  defining character translations using the  menu  button,  the 
  171.        same method is used for input as in defining configuration  strings 
  172.        above.
  173.  
  174.        Once the character matrix is defined, move the mouse pointer to the 
  175.        magenta  word  "End"  at  position  127  in  the  character  matrix 
  176.        (character 127 - delete - cannot be redefined) and press any  mouse 
  177.        button.
  178.  
  179. Saving the hex file
  180.  
  181.        Once "End" has been selected on the character matrix,  the user  is 
  182.        given  an opportunity to repeat the whole dialogue.  If only a  few 
  183.        fields  were  originally  entered in  error,  then  the  method  of 
  184.        providing the previously-entered value as a default means that  the 
  185.        user  can  simply press <Return> to skip this question  giving  the 
  186.        same response as last time.
  187.  
  188.        This process may be repeated many times.  Once the option has  been 
  189.        selected to save the file, processing continues in a similar manner 
  190.        to loading a file (see above).
  191.  
  192.        A catalogue of "&.1WP.hex" is displayed if it is available, and the 
  193.        user is prompted for a filename. If a printer driver was previously 
  194.        loaded, it's filename will be the default. If no printer driver was 
  195.        loaded,  the  first  word  of the printer name will be  used  as  a 
  196.        default filename.  If this contains bad characters for a  filename, 
  197.        ADFS  will  generate an error,  and the user is re-prompted  for  a 
  198.        filename.
  199.  
  200. Any Queries
  201.  
  202.        If you still have any queries,  I will be glad to help - contact me 
  203.        via Paul Beverley of Archive.
  204.  
  205.